home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / misc / autorais.zoo / autorais.doc < prev   
Text File  |  1992-12-29  |  5KB  |  109 lines
  1.  
  2.     AutoRaise 2.0 docs        29th December 1992
  3.  
  4.                                     (Look, I know I shouldn't be writing software
  5.                                      on my birthday...)
  6.     
  7.     Annius Groenink
  8.     Laan van Borgele 24
  9.     7415 DJ Deventer
  10.     The Netherlands
  11.     +31 5700 29396
  12.     AVGROENI@CS.RUU.NL
  13.  
  14.  
  15. INTRODUCTION
  16.  
  17.     AutoRaise 2.0 is the second,  enhanced  version  of  AUTORAIS,  which
  18.     (V1.1) I released as freeware a year and a  half  ago  and  has  been
  19.     widely spread partly because it appeared on the  cover  disk  of  the
  20.     British magazine ST User. [Very impolite of ST User, by the  way,  is
  21.     that they seem to think 'freeware'  means  they  can  just  put  your
  22.     program on a cover disk without even sending you a letter and a  copy
  23.     of the magazine... a terrible shame!]
  24.     
  25.     AutoRaise is a small program that raises windows for you.  This  will
  26.     make your Atari feel faster and easier to use.
  27.  
  28.  
  29. COPYING
  30.  
  31.     AutoRaise 2.0 is freeware. You may freely  copy  and  distribute  the
  32.     AutoRaise executable, provided that this document file  is  included.
  33.     For any other purposes like publication in a magazine  or  commercial
  34.     public domain catalogue, or any other situation where money  of  some
  35.     kind is involved, permission of the  author  is  needed.  All  rights
  36.     reserved; AutoRaise and these documents are (C) 1992 Annius Groenink.
  37.  
  38.  
  39. WHY USE AutoRaise
  40.  
  41.     1. If you have always had to click on a window to top it,  especially
  42.         with single tasking TOSes, where nothing can be done in background
  43.         windows unless they belong to the active application,  you  simply
  44.         don't know what you've been missing.  Try  AutoRaise,  and  you'll
  45.         feel far more comfortable with GEM than you  did  (it  might  even
  46.         prevent you from buying that cheap 486 you saw in the  paper  this
  47.         morning...)
  48.  
  49.     2. If you use/have used Double Click's  'equivalent'  DCTOPPER:  this
  50.         program sticks to all conventions and is hence TOS-independent. It
  51.         tops windows less quickly, and hardly ever tops a window when  you
  52.         don't want it to; this version 2.0 includes fixes for a number  of
  53.         frequently occurring cases where a window is topped when the  user
  54.         clearly does not want it to be raised.
  55.  
  56.  
  57. WHAT'S NEW IN THIS VERSION
  58.  
  59.     1. AutoRaise 2.0 will work with   any   TOS,   and   with   the   new
  60.         multitasking AES. The problem with MultiTOS was that the simulated
  61.         mouse clicks  could  be  on  the  window's  gadgets,  which  could
  62.         sometimes even close    a    window!    MultiTOS    provides    an
  63.         alternative, which makes use of the new wind_get  option  WF_OWNER
  64.         to send a WM_TOPPED message  to  the  relevant  AES  process.  The
  65.         accessory will do whatever is right in your OS.
  66.  
  67.     2. AutoRaise 2.0 raises windows less often than AutoRaise V1.1; to be
  68.         precise:
  69.     
  70.         - A window is topped only after the mouse has been stationary  for
  71.             one tenth of a second. This used to be: the mouse  was  on  the
  72.             same window. You can now slowly move the mouse towards the menu
  73.             bar, crossing a background window,  without  the  window  being
  74.             topped. As long as you move the mouse faster than one pixel per
  75.             tenth of a second, which I think is OK.
  76.  
  77.         - Windows will not be topped when any of the four  shift  keys  or
  78.             the mouse buttons are held down. So e.g. when you wish to  drag
  79.             a file out of a background window of  NEWDESK,  hold  down  the
  80.             right button, then move to the background window  and  pick  up
  81.             the file.
  82.  
  83.         - AutoRaise 2.0 does not  allow  the  current  top  window  to  be
  84.             comletely buried when it tops a window. I reckon a lot of  V1.1
  85.             users must have hated using the control panel because when  you
  86.             opened it, you had get the mouse on its  window  very  quickly,
  87.             otherwise it would be covered by  a  desktop  window.  A  pain,
  88.             especially for owners of a TTM194, or users of BigScreen or  my
  89.             STRETCH.PRG.
  90.  
  91.         - Any change of the top window NOT caused by mouse  movement  will
  92.             be 'respected', so you  can  open  and  close  windows  by  key
  93.             commands without having to worry about getting the mouse on the
  94.             right window. AutoRaise 2.0 will not top a window until  you've
  95.             moved the mouse again.
  96.  
  97.  
  98.  
  99.  
  100. ACKNOWLEDGEMENTS
  101.  
  102.     I'd like to thank Alan Kennedy for suggesting that I should wait  for
  103.     the mouse to be stationary rather than hanging around above the  same
  104.     window for a while. This major improvement of user friendliness was a
  105.     good excuse to implement the suggestions  I had from others.  Whoever
  106.     did those suggestions, ta!  (And I'd be delighted to receive more)
  107.  
  108.  
  109.